All Databases Inside Mac - WWSO Mgr

IULangOrder

Indicate sort order for two languages

#include <Packages.h> International Utilities Package

short IULangOrder( language1, language2);

LangCode language1; code indicating first language

LangCode language2; code indicating second languages

returns -1 if (ab)

Given a pair of language codes, IULangOrder indicates in what order the text

in the two languages should be sorted

language1 and . . .

language2 are the language codes of the languages to be compared.

Returns: a short;-1, 1, or 0, depending on whether text in the first language

should be sorted before, after, or in the same place as text in the

second language. The system script is always sorted first

Notes: With System 7.0, the new IUScriptOrder, IULangOrder,

IUStringOrder, IUTextOrder, and IUGetItlTable routines accept

special script or language codes. These script and language codes facilitate

the process of sorting text between scripts and languages. For these

routines, System 7.0 has defined these new types: ScriptCode and

LangCode. A valid ScriptCode type can be an integer in the range 0-64

that explicitly indicates a particular script, or it can be a negative value

with a special meaning. A valid LangCode type can be a nonnegative integer

that explicitly indicates a particular language, or it can be a negative value

with a special meaning.

A valid value for a parameter of type LangCode is a nonnegative integer

that explicitly indicates a particular language, or is one of the following

negative values:

Constant Meaning

iuSystemCurLang Current language for system script

(from script global variables)

iuSystemDefLang Default language for system script

(from 'itlm' resource)

iuCurrentCurLang Current language for current script

(from script global variables)

iuCurrentDefLang Default language for current script

(from 'itlm' resource)

iuScriptCurLang* Current language for specified script

(from script global variables)

iuScriptDefLang Default language for specified script

(from 'itlm' resource)

*If the script system is not installed, the

International Utilities Package cannot determine the current language,

so it uses the default language.

Not all of the routines that have ScriptCode or LangCode parameters

support all of the special negative values; the exceptions are noted in

relevant routine de scriptions. For details see the section entitled

Accessing the International Resources.

IUStringOrder and IUTextOrder use IUScriptOrder, IULangOrder,

and IUMagPString to return -1, 0, or 1, indicating the proper ordering

of strings that may be in different scripts or languages. If the result of

IUScriptOrder is not 0, then it is returned as the result of

IUStringOrder or IUTextOrder. If the result is 0, aLang and bLang are

checked; if these are different, then they determine the function result. If

they are not different, the strings are in the same script and language and

are compared using the sorting for that script and language. If that script is

not installed and enabled, the sorting is performed using the script specified

by IntlScript

For all of these sorting functions, invalid script or language codes are

sorted after valid ones. Note that these functions can move memory.

Referenced by (14):